Versi 1

Field	Isi
Dokumen ID	VBS-LAP-006
Deskripsi	Laporan performa bisnis (ringkasan bisnis) bulanan: ringkasan laba rugi, ringkasan neraca, ringkasan arus kas, dan wawasan rasio keuangan, beserta unduh Excel
Nomor Revisi	1
Tanggal	2026-10-04
Keterangan	Dokumentasi baseline dari dokumentasi fitur demo dan kode FE

1. Ringkasan

a. In scope

• User membuka laporan performa bisnis dari hub laporan akuntansi
• User memilih satu bulan (default bulan berjalan) lalu menampilkan laporan
• User melihat ringkasan laba rugi: pendapatan, harga pokok penjualan, biaya operasional, laba operasional (EBIT), dan laba rugi bersih
• User melihat ringkasan neraca: aset lancar, aset tidak lancar, liabilitas jangka pendek, liabilitas jangka panjang, dan modal pemilik
• User melihat ringkasan arus kas: aktivitas operasional, aktivitas non operasional, perpindahan kas bersih, dan saldo penutupan
• User melihat wawasan rasio: margin laba kotor, margin laba operasional, margin keuntungan bersih, rasio lancar, rasio hutang terhadap ekuitas, ROA, ROE, perputaran piutang dan hutang, serta rata-rata lama konversi piutang dan hutang
• User yang berhak mengunduh laporan ke Excel

b. Catatan

c. Kesimpulan

• [FE] -
• [BE] -

2. Functional Requirement

Kode	Deskripsi
FR-01	Sistem menghitung saldo akun bulanan untuk tahun dari bulan yang dipilih, seluruh cabang dan cluster
FR-02	Sistem menampilkan ringkasan laba rugi, neraca, dan arus kas untuk bulan terpilih
FR-03	Sistem menampilkan wawasan rasio keuangan untuk bulan terpilih
FR-04	User dengan hak akses Excel dapat mengunduh laporan performa bisnis
FR-05	User dapat mereset bulan dan mengosongkan laporan

3. Use Case List

Kode	Deskripsi
UC-01	Menampilkan performa bisnis per bulan
UC-02	Melihat ringkasan laba rugi, neraca, dan arus kas
UC-03	Melihat wawasan rasio keuangan
UC-04	Mengunduh laporan performa bisnis ke Excel
UC-05	Mereset bulan laporan

4. Use Case Scenario

UC-01 : Menampilkan performa bisnis per bulan

Aktor	User brand dengan akses laporan ringkasan bisnis
Deskripsi	User memuat performa bisnis untuk bulan tertentu
Prekondisi	User sudah login dan berada di konteks brand
Alur utama	1. User membuka laporan performa bisnis. 2. Sistem memuat struktur kelompok akun. 3. User memilih bulan. 4. User menekan Lihat Laporan. 5. Sistem meminta perhitungan saldo tahun berjalan, mengambil data bulan terpilih, lalu menampilkan empat bagian ringkasan.
Alur negatif	- Jika form tidak valid, muncul alert "Cek Kembali Form Isian Anda". - Jika perhitungan gagal atau data kosong, muncul notifikasi "Data yang anda filter tidak ditemukan silahkan ganti filter".
Bisnis rule	- Filter hanya berupa satu bulan, tanpa cabang atau cluster. - Perhitungan selalu untuk semua cabang dan semua cluster. - Perhitungan memakai hasil yang sudah ada tanpa memaksa hitung ulang.
Postkondisi	Laporan performa bisnis tampil
Trigger	User menekan Lihat Laporan
Kode FR	FR-01

UC-02 : Melihat ringkasan laba rugi, neraca, dan arus kas

Aktor	User brand dengan akses laporan ringkasan bisnis
Deskripsi	User melihat angka pokok keuangan bulan terpilih
Prekondisi	Laporan sudah dimuat
Alur utama	1. Sistem menampilkan bagian Ringkasan Laba Rugi. 2. Sistem menampilkan bagian Ringkasan Neraca. 3. Sistem menampilkan bagian Ringkasan Arus Kas.
Alur negatif	- Jika tidak ada data bulan terpilih, nilai tampil nol atau laporan kosong.
Bisnis rule	- Pendapatan, HPP, biaya, dan laba dihitung dari kelompok akun 4 sampai 9. - Aset lancar dan liabilitas dikelompokkan berdasarkan nomor sub kelompok akun. - Modal pemilik diambil dari akun berawalan 31.
Postkondisi	Ringkasan keuangan terlihat
Trigger	Laporan selesai dimuat
Kode FR	FR-02

UC-03 : Melihat wawasan rasio keuangan

Aktor	User brand dengan akses laporan ringkasan bisnis
Deskripsi	User membaca rasio kesehatan bisnis
Prekondisi	Laporan sudah dimuat
Alur utama	1. User menggulir ke bagian Wawasan. 2. Sistem menampilkan margin laba kotor, margin laba operasional, margin keuntungan bersih, rasio lancar, rasio hutang terhadap ekuitas, ROA, ROE, rasio perputaran piutang, rata-rata lama konversi piutang, rasio perputaran hutang, dan rata-rata lama konversi hutang.
Alur negatif	- Jika pembagi bernilai nol, rasio tampil nol atau tidak terdefinisi sesuai hasil hitung di layar.
Bisnis rule	- Rasio dihitung di sisi aplikasi dari angka ringkasan laba rugi dan neraca bulan yang sama.
Postkondisi	Wawasan rasio terlihat
Trigger	Laporan selesai dimuat
Kode FR	FR-03

UC-04 : Mengunduh laporan performa bisnis ke Excel

Aktor	User brand dengan hak akses Excel laporan ringkasan bisnis
Deskripsi	User mengunduh isi laporan yang sedang tampil
Prekondisi	Laporan sudah ditampilkan
Alur utama	1. User menekan Unduh File. 2. Sistem menyusun sheet per bagian ringkasan beserta nominal tiap baris. 3. Browser mengunduh "Laporan Performa Bisnis.xlsx".
Alur negatif	- Jika filter belum diterapkan, muncul alert "Silahkan Filter Terlebih dahulu data yang ingin ditampilkan". - Jika data kosong, muncul notifikasi "Data tidak ditemukan".
Bisnis rule	- Tombol Unduh File hanya tampil untuk user dengan permission Excel laporan ringkasan bisnis.
Postkondisi	File Excel terunduh
Trigger	User menekan Unduh File
Kode FR	FR-04

UC-05 : Mereset bulan laporan

Aktor	User brand dengan akses laporan ringkasan bisnis
Deskripsi	User mengembalikan filter ke kondisi awal
Prekondisi	Halaman laporan terbuka
Alur utama	1. User menekan tombol reset. 2. Laporan dikosongkan dan tampil pesan "Lengkapi filter untuk menampilkan data".
Alur negatif	-
Bisnis rule	-
Postkondisi	Laporan kosong
Trigger	User menekan tombol reset
Kode FR	FR-05

5. Data Flow Diagram

DFD-01 — Laporan performa bisnis

6. Sequence Diagram

SD-01 — UC-01 : Menampilkan performa bisnis per bulan

SD-02 — UC-02 : Melihat ringkasan laba rugi, neraca, dan arus kas

SD-03 — UC-03 : Melihat wawasan rasio keuangan

SD-04 — UC-04 : Mengunduh laporan performa bisnis ke Excel

SD-05 — UC-05 : Mereset bulan laporan

7. Table Schema

8. API Schema

Endpoint	Status	Perubahan
GET /kelompok/with-includes	existing	-
POST /calculation-request/start	existing	-